home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / tex / flip1exe.zip / FLIP.MAN < prev    next >
Text File  |  1989-07-21  |  5KB  |  130 lines
  1.  
  2.      FLIP(1)                  REFERENCE MANUAL              FLIP(1)
  3.  
  4.  
  5.      NAME
  6.           flip - do newline conversions between **IX and MS-DOS
  7.  
  8.      SYNOPSIS
  9.           flip -h
  10.           flip -umvtsbz file ...
  11.  
  12.      DESCRIPTION
  13.           Flip is a file interchange program that converts text file
  14.           formats between **IX and MS-DOS.  It converts lines ending
  15.           with carriage-return (CR) and linefeed (LF) to lines ending
  16.           with just linefeed, or vice versa.
  17.  
  18.           Flip has the following features.
  19.  
  20.           o    If a file contains isolated CR characters for
  21.                underlining or overprinting, flip does not change them.
  22.  
  23.           o    When asked to convert a file to the same format that it
  24.                already has, flip causes no change to the file.  Thus
  25.                to convert all files to **IX format you can type
  26.  
  27.                     flip -u *.*  (under MS-DOS)
  28.                     flip -u *    (under **IX)
  29.  
  30.                and all files will end up right, regardless of whether
  31.                they were in MS-DOS or in **IX format to begin with.
  32.                This also works in the opposite direction.
  33.  
  34.           o    Flip preserves file timestamps.  You can override this.
  35.  
  36.           o    Flip is written in C and will compile and run under
  37.                MS-DOS/Turbo C, 4.3BSD, and System V.
  38.  
  39.           o    Flip accepts wildcards and multiple filenames on the
  40.                command line.
  41.  
  42.           o    If a user interrupt aborts Flip, it does not leave
  43.                behind any garbage files or cause corruption of the
  44.                files being converted.
  45.  
  46.           o    Flip will normally refuse to convert binary files.  You
  47.                can override this.
  48.  
  49.           o    When converting from MS-DOS to **IX format, flip
  50.                removes any trailing control Z (the last character in
  51.                the file), but leaves embedded control Z characters
  52.                unchanged.  This minimizes the possibility of
  53.                accidentally converting a binary file that contains a
  54.                control Z near the beginning.  You can override this
  55.                and ask flip to recognize the first control Z found as
  56.                end-of-file.
  57.  
  58.           o    Flip can be asked to strip the high (parity) bit as it
  59.                converts a file.
  60.  
  61.           Flip is normally invoked as:
  62.  
  63.                flip -umhvtb file ...
  64.  
  65.           One of -u, -m, or -h is required.  Switches may be given
  66.           separately or combined together after a dash.  For example,
  67.           the three command lines given below are equivalent:
  68.  
  69.                flip -uvt *.c
  70.                flip -u -v -t *.c
  71.                flip -u -vt *.c
  72.  
  73.           The meanings of the switches are as follows.
  74.  
  75.           -u   convert to **IX format (CR LF => LF, lone CR or LF
  76.                unchanged, trailing control Z removed, embedded control
  77.                Z unchanged)
  78.  
  79.           -m   convert to MS-DOS format (lone LF => CR LF, lone CR
  80.                unchanged)
  81.  
  82.           -h   give a help message
  83.  
  84.           -v   be verbose, print filenames as they are processed
  85.  
  86.           -t   touch files (don't preserve timestamps)
  87.  
  88.           -s   strip high bit
  89.  
  90.           -b   convert binary files too (else binary files are left
  91.                unchanged)
  92.  
  93.           -z   truncate file at first control Z encountered
  94.  
  95.           On systems that allow a program to know its own name, flip
  96.           may be renamed (or linked) to a file called toix (or
  97.           toix.exe under MS-DOS) for conversion to **IX format, or to
  98.           a file called toms (or toms.exe under MS-DOS) for conversion
  99.           to MS-DOS format.  When invoked with the name toix or toms,
  100.           flip will act as if it were invoked with the -u or -m option
  101.           respectively.
  102.  
  103.      COPYRIGHT
  104.           Both this documentation and flip are Copyright 1989 Rahul
  105.           Dhesi, all rights reserved.  Permission is granted to copy,
  106.           use, and distribute for any commercial or noncommercial
  107.           purpose in accordance with the requirements of version 1.0
  108.           of the GNU General Public license.
  109.  
  110.           Note:  This software has not been endorsed by the Free
  111.           Software Foundation, the creator of the GNU license, and I
  112.           am not affiliated with that organization.
  113.  
  114.      AUTHOR
  115.           Rahul Dhesi
  116.  
  117.      DATE
  118.           This manual was formatted 1989/04/07 and revised 1989/04/21.
  119.           It is for version 1.00 of flip except for the note below.
  120.  
  121.      NOTE
  122.           The current MS-DOS version of flip is 1.0a.  The only change
  123.           from version 1.0 is that version 1.0a preserves the status of
  124.           the MS-DOS 'break' flag.  To implement this change in the
  125.           source code, replace the last statement in the main()
  126.           function, currently a 'return' statement, by the following
  127.           statement:
  128.  
  129.                flip_exit (exitstat);
  130.